PATH Mac OS 8 and 9 Developer Documentation > Text and Other International Services > Apple Type Services for Unicode Imaging (ATSUI) > Apple Type Services for Unicode Imaging Reference
     

ATSUGetFontVariationValue

Obtains the font variation value of a font variation axis.

OSStatus ATSUGetFontVariationValue (
                     ATSUStyle iStyle,
                     ATSUFontVariationAxis iATSUFontVariationAxis,
                     ATSUFontVariationValue *oATSUFontVariationValue);
iStyle
A reference of type ATSUStyle. Pass a reference to a valid style object whose font variation value you want to obtain. You cannot pass NULL for this parameter.

iATSUFontVariationAxis
A value of type ATSUFontVariationAxis. Pass the font variation axis whose value you want to obtain.

oATSUFontVariationValue
A pointer to a value of type ATSUFontVariationValue. On return, the value corresponding to the font variation axis. If this value has not been set, ATSUGetFontVariationValue passes back the font-defined default value and returns the result code kATSUNotSetErr. You cannot pass NULL for this parameter.

function result
A result code. See Result Codes.
DISCUSSION
Before calling ATSUGetFontVariationValue, call the function ATSUGetAllFontVariations to obtain an array of variation axes corresponding to all previously set font variations. You can then call ATSUGetFontVariationValue with the appropriate variation axis to determine the corresponding variation value.

VERSION NOTES
Available beginning with ATSUI 1.0.
© 2000 Apple Computer, Inc. – (Last Updated 25 Jan 00)